home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 8 / tm121.exe / lha / TM.DOC < prev    next >
Text File  |  1990-05-16  |  43KB  |  1,046 lines
  1.  
  2.  
  3.  
  4.  
  5.                                 TreeMaster 1.21
  6.  
  7.                            Copyright 1990 by New-Ware
  8.  
  9.                               All Rights Reserved
  10.  
  11.                       (tm)  ┌─────────┐
  12.                       ┌─────┴───┐     │ MEMBER
  13.                    ───│         │     │────────────────
  14.                       │  ┌──────┴──┐  │ Association of
  15.                       │  │         ├──┘   Shareware
  16.                       └──┤    ■    │    Professionals
  17.                    ──────│    ║    │───────────────────
  18.                          └────╨────┘
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                                  Contents
  29.  
  30.  
  31.                INTRODUCTION  . . . . . . . . . . . . . . . . . . . .  2
  32.                PRODUCT REGISTRATION  . . . . . . . . . . . . . . . .  3
  33.                VERSION HISTORY . . . . . . . . . . . . . . . . . . .  4
  34.                GENERAL PROGRAM DESCRIPTION . . . . . . . . . . . . .  5
  35.                PROGRAM OPERATION . . . . . . . . . . . . . . . . . .  5
  36.                   STARTING TM  . . . . . . . . . . . . . . . . . . .  5
  37.                   MAIN TM DISPLAY  . . . . . . . . . . . . . . . . .  6
  38.                   THE CURSOR BAR . . . . . . . . . . . . . . . . . .  6
  39.                   MOUSE SUPPORT  . . . . . . . . . . . . . . . . . .  7
  40.                   FUNCTION KEY COMMANDS  . . . . . . . . . . . . . .  7
  41.                   F-1 KEY  . . . . . . . . . . . . . . . . . . . . .  8
  42.                   F-2 KEY  . . . . . . . . . . . . . . . . . . . . .  8
  43.                   F-3 KEY  . . . . . . . . . . . . . . . . . . . . .  8
  44.                   F-4 KEY  . . . . . . . . . . . . . . . . . . . . .  8
  45.                   F-5 KEY  . . . . . . . . . . . . . . . . . . . . .  8
  46.                   F-6 KEY  . . . . . . . . . . . . . . . . . . . . .  8
  47.                   F-7 KEY  . . . . . . . . . . . . . . . . . . . . .  9
  48.                   F-8 KEY  . . . . . . . . . . . . . . . . . . . . .  9
  49.                   F-9 KEY  . . . . . . . . . . . . . . . . . . . . .  9
  50.                   F-10 KEY . . . . . . . . . . . . . . . . . . . . . 10
  51.                   OTHER TM COMMANDS  . . . . . . . . . . . . . . . . 10
  52.                   INS KEY  . . . . . . . . . . . . . . . . . . . . . 10
  53.                   DEL KEY  . . . . . . . . . . . . . . . . . . . . . 10
  54.                   CTRL-END KEY . . . . . . . . . . . . . . . . . . . 11
  55.                   CTRL-HOME KEY  . . . . . . . . . . . . . . . . . . 11
  56.                   TAB KEY  . . . . . . . . . . . . . . . . . . . . . 11
  57.                   CTRL-M KEY . . . . . . . . . . . . . . . . . . . . 11
  58.                   CTRL-S KEY . . . . . . . . . . . . . . . . . . . . 12
  59.                FILE BROWSE MODE  . . . . . . . . . . . . . . . . . . 12
  60.                DIRECTORY NAME SEARCH . . . . . . . . . . . . . . . . 12
  61.                PROGRAM LIMITATIONS . . . . . . . . . . . . . . . . . 13
  62.                ERROR HANDLING  . . . . . . . . . . . . . . . . . . . 13
  63.                CREDITS
  64.                        . . . . . . . . . . . . . . . . . . . . . . . 14
  65.  
  66.          Index                                                       17
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.                                        i
  76.  
  77.  
  78.     INTRODUCTION
  79.  
  80.         The program author, John J. Newlin, is an active member of the
  81.     Association of Shareware Professionals (ASP).  The ASP wants to make
  82.     sure that the Shareware principle works for you. If you are unable to
  83.     resolve a Shareware related problem with an ASP member by contacting the
  84.     member directly, ASP may be able to help. The ASP Ombudsman can help you
  85.     resolve a dispute or problem with an ASP member, but does not provide
  86.     technical support for members' products. Please write to the ASP
  87.     Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve
  88.     message via EASYPLEX to ASP Ombudsman 70007,3536.
  89.  
  90.                                    DISCLAIMER
  91.  
  92.          New-Ware hereby disclaims all warranties relating to this product,
  93.     whether express or implied, including without limitation any implied
  94.     warranties of merchantability or fitness for a particular purpose. New-
  95.     Ware cannot and will not be liable for any special, incidental,
  96.     consequential, indirect or similar damages due to loss of data or any
  97.     other reason, even if New-Ware or an authorized New-Ware agent has been
  98.     advised of the possibility of such damages.  In no event shall the
  99.     liability for any damages ever exceed the price paid for the license to
  100.     use software, regardless of the form and/or extent of the claim.  The
  101.     user of this program bears all risk as to the quality and performance of
  102.     the software.
  103.  
  104.                                  PRODUCT LICENSE
  105.  
  106.          TreeMaster is a Shareware product.  As such, it is made available
  107.     to the general computing public for evaluation.  Users are licensed to
  108.     operate TreeMaster on their personal computers for the purpose of test
  109.     and evaluation on a trial basis for a limited trial period.  It is not
  110.     possible to reasonably define any definitive limits of a fair and
  111.     equitable time period for evaluation, therefore it is left to the user's
  112.     judgment and sense of fair play as to the time required to make a
  113.     decision as to its usefulness.  If the user decides the program is not
  114.     of sufficient merit to warrant purchase through registration with New-
  115.     Ware, the program should be removed from their personal computer.
  116.     Otherwise, if the program is deemed useful and is in regular use on the
  117.     user's personal computer system, registration with New-Ware is required.
  118.  
  119.          Registered users are those users that elect to pay for TreeMaster
  120.     and register that payment with New-Ware.  By virtue of registration and
  121.     payment for the program, registered users are granted a license to
  122.     continue to utilize the program on their personal computer for as long
  123.     as they choose.  This license authorizes the user to use the program on
  124.     any personal computer system he or she may own so long as the program is
  125.     operated on only one computer system at a time.
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                      - 2 -
  132.  
  133.  
  134.  
  135.     PRODUCT REGISTRATION
  136.  
  137.          TreeMaster is sole property of New-Ware Shareware Products. The
  138.     Shareware version, and ONLY that version, may be freely copied and
  139.     transferred to individual parties for evaluation purposes.  The
  140.     Shareware version, and ONLY that version, may be posted on Bulletin
  141.     Board systems (BBS) for electronic access as long as NO FEE is charged
  142.     for its distribution except for private BBS operations that charge a
  143.     regular user subscription fee.  Computer information services such as
  144.     Compuserve (CIS) and Genie, etc., are authorized to post this product
  145.     for subscriber access.  The Shareware version of TreeMaster may NOT be
  146.     distributed on diskette by any disk distributor/vendor that charges more
  147.     than $12.00 for the diskette upon which the program and attendant files
  148.     are recorded without written consent from New-Ware.
  149.  
  150.          TreeMaster is a fully functional Shareware product.  Shareware is a
  151.     computer program distribution/marketing method that permits potential
  152.     buyers to thoroughly try the program prior to purchase. It is NOT free
  153.     and it is not in the Public Domain.  If, after evaluating the program,
  154.     you find it to be useful enough to use it on a regular basis, you are
  155.     expected to pay for it by registering with New-Ware. The registration
  156.     fee is $25.00 and the registered version, which is NOT distributed as
  157.     Shareware, will not contain the opening Shareware screen nor the closing
  158.     messages.
  159.  
  160.     You may register TreeMaster in one of three ways:
  161.  
  162.     1) By mail with check or money order to:
  163.  
  164.                              New-Ware
  165.                              8050 Camino Kiosco
  166.                              San Diego, CA 92122-1820
  167.  
  168.     2) By telephone with Visa/Mastercard to:
  169.  
  170.                              New-Ware
  171.                              (619) 455-6225
  172.  
  173.     3) Electronically through the New-Ware BBS:
  174.  
  175.                    New-Ware Shareware Products BBS
  176.                    Running Wildcat! version 2.10p
  177.  
  178.                    (619) 450-3257 - Node #1 1200/2400/9600 (HST)
  179.                          455-5226 - Node #2 1200/2400
  180.  
  181.          The New-Ware Shareware Products BBS operates 24 hours per day, 7
  182.     days per week.  Node #1 is dedicated to registered users only.  Nodes #2
  183.     is open to all callers.  Users registering via the BBS receive access to
  184.     the latest registered version within 1 day after leaving their credit
  185.  
  186.  
  187.  
  188.                                      - 3 -
  189.  
  190.  
  191.  
  192.     card data.  Users who register by mail or phone may also access the
  193.     registered version by BBS, but you  MUST log on and leave a comment to
  194.     the sysop to the effect that you are a registered user and desire
  195.     access.  The author can also on CIS via PPN 71535,665 (please use
  196.     EASYPLEX).
  197.  
  198.          This Shareware version of TreeMaster may be freely copied and
  199.     passed on to other individual users for their evaluation.  Disk vendors
  200.     and/or distributors that desire to distribute TreeMaster must adhere to
  201.     the guidelines presented in the file VENDOR.DOC.
  202.  
  203.          Press Alt-R from the opening Shareware screen or the main
  204.     TreeMaster display to activate the registration window.  Prompts will be
  205.     issued for the pertinent information and you will have the option of
  206.     printing the registration form when the form is completed.  The
  207.     Shareware version is completely functional.  The only differences
  208.     between it and the version a registered user receives is the opening
  209.     Shareware screen and the ability to print the registration form.
  210.  
  211.     CALIFORNIA RESIDENTS MUST INCLUDE 7.25% STATE SALES TAX!
  212.  
  213.          I support my software.  One of the great strengths of the Shareware
  214.     concept is the interaction between the program author and the users.
  215.     Many of the features contained in TreeMaster are the result of user
  216.     input.  If you have a problem evaluating this program or desire to make
  217.     a suggestion or comment (or even a complaint), please do not hesitate to
  218.     contact me.  Even if you register TreeMaster, if you later determine
  219.     that it is unsuitable for your use, you may contact me for a refund.  It
  220.     is not necessary that you be a registered user to contact me for
  221.     technical support.  Technical support will be available through the U.S
  222.     mail, telephone, or the New-Ware BBS.
  223.  
  224.     VERSION HISTORY
  225.  
  226.          1.00 - Released 05-05-90
  227.  
  228.          1.10 - Released 05-08-90
  229.               - Minor bug fixes.
  230.               - Removed beeps during file search.
  231.               - Added directory memo editor.
  232.               - Added context sensitive on-line help.
  233.               - Added capability to LIST non-executable files.
  234.  
  235.          1.20 - Released 05-11-90
  236.               - Complete revision of file browsing.  Added full
  237.                 browsing of sorted file list found through the search
  238.                 function or in a specific directory.
  239.               - Added mouse support.
  240.               - Added capability to call ArcMaster.
  241.               - Added capability to edit a file with QEDIT.
  242.  
  243.  
  244.  
  245.                                      - 4 -
  246.  
  247.  
  248.  
  249.          1.21 - Release 05-15-90
  250.               - Improved the speed of the nested (filename/ext) sort
  251.                 by a factor of 10.
  252.               - Added Kim Kokkonen's (TurboPower Software) EMS/Disk
  253.                 swapping unit for use in calling external programs.
  254.               - Added support for calls to the following programs:
  255.                    > PKZIP/PKUNZIP from PKWare
  256.                    > VirusSCAN from McAfee
  257.                    > LZESHELL from Pete Petrakis
  258.  
  259.     GENERAL PROGRAM DESCRIPTION
  260.  
  261.          TreeMaster, hereinafter referred to as TM, is a powerful, full-
  262.     featured hard disk directory manager.  With the advent of DOS 2.0, a
  263.     hierarchical directory tree structure was implemented to facilitate the
  264.     organization of files.  Unfortunately, this tree structure can be very
  265.     clumsy to utilize from the DOS prompt level with such commands as CHDIR
  266.     and DIR.  In fact, there is no intrinsic DOS command that displays the
  267.     current directory tree structure.  Trying to remember the tree,
  268.     especially if it is large, can be a real pain and an even worse pain is
  269.     all the typing required to access directories that are more than one
  270.     level deep on the tree.
  271.  
  272.          TM is designed to make navigation of a hard disk and its attendant
  273.     directory tree structure a snap.  TM displays the directory structure as
  274.     a graphic tree, twenty directories per page and all the directories are
  275.     alphabetically sorted within tree levels of depth.  Through the use of a
  276.     movable cursor bar and function key commands, the user may accomplish a
  277.     great deal of directory management functions quickly and easily.  For
  278.     example, directories may be added, deleted, purged, or renamed with just
  279.     a few keystrokes.  And the auxiliary disk information and file windows
  280.     keep the user fully informed as to the current status of the directory
  281.     organization.
  282.  
  283.          There's much, much more to TM.  It is very intuitive and quite easy
  284.     to use, but it is recommended that the remainder of this document be
  285.     perused before running this excellent utility.
  286.  
  287.     PROGRAM OPERATION
  288.  
  289.          STARTING TM
  290.  
  291.               Starting and running TM is simple.  It accepts only one
  292.          command line parameter.  If started with no parameter, TM will
  293.          operate on the currently active drive.  If the user desires to
  294.          operate on another drive, simply add the drive letter (upper or
  295.          lower case, no colon) as a command parameter.  For example:
  296.  
  297.                              TM d
  298.  
  299.  
  300.  
  301.  
  302.                                      - 5 -
  303.  
  304.  
  305.  
  306.               In this example, TM will load and begin operation on drive D.
  307.  
  308.               As distributed, TM is configured to automatically detect and
  309.          utilize either monochrome or color monitors.  Some monitors,
  310.          however, report themselves as color monitors but do not fully
  311.          support the standard color attributes.  Laptop computers are
  312.          typical of this group.  If the display problematic for this reason,
  313.          press Ctrl-T to activate the TM configuration window, press the "C"
  314.          key to toggle TM to the "Force mono mode", and then save the
  315.          configuration to disk.  The next time TM is run, it will go into a
  316.          monochrome mode, which is much more readable on a laptop monitor.
  317.  
  318.               TM may be operated from any drive:\directory in a system
  319.          providing that the directory in which it resides is identified in
  320.          the DOS PATH statement.  Please see the file PATHINFO.TXT for an
  321.          explanation of how to utilize the DOS PATH capability.  To exit
  322.          from TM and remain in the directory from which it was loaded, press
  323.          the Esc key or press Alt-X.  Pressing the Esc key to exit affords
  324.          the user the opportunity to confirm the intention to quit the
  325.          program.
  326.  
  327.          MAIN TM DISPLAY
  328.  
  329.               The main display of TM is designed to provide the maximum
  330.          amount of information without cluttering up the screen.  The
  331.          graphic tree is contained in a window which occupies the full left
  332.          side of the screen.  The upper right hand corner of the screen is
  333.          occupied by a window that shows information pertinent to the
  334.          currently active drive.  A window in the lower right hand of the
  335.          screen will display up to ten files from the directory that is
  336.          currently highlighted by the cursor bar.  Each time the cursor is
  337.          moved, the file list window is updated.  This window also has a
  338.          functional use in support of executing programs, which will be
  339.          described later.
  340.  
  341.          THE CURSOR BAR
  342.  
  343.               Operation of TM is primarily based upon use of the cursor bar
  344.          in a "point-and-shoot" manner.  The Up/Down arrows, PgUp/PgDn, and
  345.          Home/End keys are used to move the cursor.  Pressing the Home key
  346.          positions the cursor at the first directory on the tree.  The End
  347.          key moves the cursor to the last directory on the tree.  PgUp and
  348.          PgDn can be used to page through a tree that has more than twenty
  349.          directories.
  350.  
  351.               Operation of the Up/Down Arrow keys may seem a bit confusing
  352.          at first, but most users will eventually appreciate the flexibility
  353.          inherent in this design.  In the default cursor movement mode,
  354.          these keys move the cursor up and down one directory at a time,
  355.          regardless of level.  The Tab key is used to toggle the movement
  356.  
  357.  
  358.  
  359.                                      - 6 -
  360.  
  361.  
  362.  
  363.          mode.  Thus the Up/Down arrow keys can be set to move up and down
  364.          one directory at a time regardless of level or can be set to move
  365.          up and down at the same level only.  Regardless of the current
  366.          setting, the Right Arrow key will always move the cursor down to
  367.          the next directory regardless of level and the Left Arrow key will
  368.          always move the cursor up in the same manner.
  369.  
  370.               As the cursor bar is moved, TM performs several ancillary
  371.          functions.  One of these functions is to display a subset of the
  372.          files (10 files at a time) found in the directory currently
  373.          highlighted by the cursor bar.  Up to 10 files (first 10 found by
  374.          DOS) can be displayed in the file list window, which is located in
  375.          the bottom right portion of the main TM display.  A major function
  376.          of the cursor bar is to facilitate changing the active directory.
  377.          All the user need do is position the cursor over the desired
  378.          directory and press the ENTER key.  When this occurs, TM will
  379.          change to the target directory and terminate, leaving the user in
  380.          the new directory.
  381.  
  382.          MOUSE SUPPORT
  383.  
  384.               TM will automatically detect the presence of a system mouse
  385.          drive and activate the mouse if one is present.  The directory tree
  386.          cursor bar can be moved by moving the mouse up and down or right
  387.          and left.  The mouse left button emulates the Enter Key, the right
  388.          button emulates the Esc Key, and pressing both left and right
  389.          buttons together calls help.  The mouse is not active while in the
  390.          directory memo editor.
  391.  
  392.          FUNCTION KEY COMMANDS
  393.  
  394.               The majority of functions provided by TM can be accessed via
  395.          one of the ten function keys.
  396.  
  397.                    F1   -   On-line Help
  398.                    F2   -   Directory Data Display
  399.                    F3   -   Change Drive
  400.                    F4   -   Print Directory Tree
  401.                    F5   -   Search for File
  402.                    F6   -   Rename Directory
  403.                    F7   -   Edit Directory Memo
  404.                    F8   -   Toggle File List ON/OFF
  405.                    F9   -   Browse Files in Directory
  406.                    F10  -   Configure TM
  407.  
  408.          Each of these functions will be explained in greater detail in the
  409.          following subsections.
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.                                      - 7 -
  417.  
  418.  
  419.  
  420.               F-1 KEY
  421.  
  422.                    The F-1 Key is used to access the on-line context
  423.               sensitive help system incorporated into TM.  When pressed
  424.               while the tree cursor is active, the main help index will be
  425.               displayed.  If pressed while in any other TM function, help
  426.               for the active function is displayed.  The Alt-F1 key can be
  427.               used to return to the last help topic displayed while in the
  428.               help system.  Mouse users may press the LEFT and RIGHT mouse
  429.               buttons to invoke the help function.
  430.  
  431.               F-2 KEY
  432.  
  433.                    The F-2 key activates a window that contains much
  434.               interesting information about the contents of the directory
  435.               currently under the cursor bar.  This drive information
  436.               display will show the total number of files, number of files
  437.               with hidden/read-only/system attributes, the largest and
  438.               smallest files, the oldest and newest files, and other
  439.               information.
  440.  
  441.               F-3 KEY
  442.  
  443.                    The F-3 key is used to change drives.  Any valid drive in
  444.               the system may be accessed by simply pressing the letter key
  445.               that corresponds to the DOS drive letter.  If the selected
  446.               drive is not valid or the drive is not ready, an error message
  447.               will appear in an error window.
  448.  
  449.               F-4 KEY
  450.  
  451.                    A printout of the graphic directory tree can be obtained
  452.               by pressing the F-4 key.
  453.  
  454.               F-5 KEY
  455.  
  456.                    TM provides a very rapid file search of the entire active
  457.               drive for a specified file name.  To search for a file, press
  458.               the F-5 key and then enter the file name as prompted for in
  459.               the file search window that will appear.  DOS wild cards ("*"
  460.               and "?") are permitted.  TM will gather all files found on the
  461.               current drive that match the entered file specification and
  462.               present the list in the file browse mode.  See the File Browse
  463.               Mode section for further details.
  464.  
  465.               F-6 KEY
  466.  
  467.                    TM makes it very easy to rename a directory.  Pressing
  468.               the F-6 key will activate a window that will prompt for the
  469.               new name of the directory under the cursor bar.  Any legal DOS
  470.  
  471.  
  472.  
  473.                                      - 8 -
  474.  
  475.  
  476.  
  477.               directory name may be entered.  This includes names that
  478.               contain a period, as in LONGNAME.DAT.   If the entered name is
  479.               the same as the name of a directory at the same level, an
  480.               error window will appear, otherwise the directory will be
  481.               renamed.  The graphic tree is resorted after the renaming of a
  482.               directory.
  483.  
  484.               F-7 KEY
  485.  
  486.                    TM supports maintenance of a small ASCII text memo file
  487.               for each directory.  The memo file serves to provide the user
  488.               with a means of keeping comments or other data pertinent to
  489.               specific directories.  To edit or create a memo file, press
  490.               the F7 key.  A window will appear that supports a full-
  491.               featured text editor.  Up to 12 lines, 40 characters each, may
  492.               be entered into the text buffer.  Standard WordStar style
  493.               commands are employed while in the buffer.  A status line at
  494.               the top of the editor window shows column number, line number,
  495.               Insert key status, and percent of buffer space used.  Press F1
  496.               while in the editor for a list of basic editor commands.
  497.  
  498.                    To save the memo, press F10 when entry of the desired
  499.               information is complete.  A file named DIRMEMO.TM will be
  500.               created in the directory highlighted by the tree cursor when
  501.               F7 was pressed.  Press Esc to exit the editor without creating
  502.               or updating the file.  If a file named DIRMEMO.TM exists in
  503.               the directory under the cursor bar when F7 is pressed, TM will
  504.               read that file into the buffer for examination and editing.
  505.               Note that the mouse is not active while the memo editor is
  506.               active.
  507.  
  508.               F-8 KEY
  509.  
  510.                    TM will normally display the first 10 files found in each
  511.               directory as the cursor bar is moved through the tree.  This
  512.               slows down the cursor movement a bit due to the requirement to
  513.               access the disk, especially on slower drives.  Pressing F-8
  514.               Key toggles this feature on and off.  When toggled off, TM
  515.               does not access the disk to get the first 10 files and the
  516.               message "File List Disabled" appears at the top of the file
  517.               list window.  The file list will automatically turned on
  518.               during a file search if the target file is found and the user
  519.               elects to stop the search normally.
  520.  
  521.               F-9 KEY
  522.  
  523.                    The F-9 key is used to browse all files in the directory
  524.               under the tree cursor bar that match the current file mask.
  525.               The file mask can be changed with the Ctrl-M command.  See the
  526.               File Browse Mode section for further details.
  527.  
  528.  
  529.  
  530.                                      - 9 -
  531.  
  532.  
  533.  
  534.               F-10 KEY
  535.  
  536.                    Pressing the F-10 key brings up a sliding bar menu that
  537.               permits configuring TM.  Pressing the Enter Key will alter the
  538.               setting of the item under the cursor bar.  If Quit and Save is
  539.               selected, TM will save the configuration file TMCONFIG.BIN to
  540.               the directory that TM.EXE resides in providing that this
  541.               directory is on the DOS PATH.  If it is not, TM will save
  542.               TMCONFIG.BIN to the current directory.  When TM loads and
  543.               executes, it searches the DOS path for TMCONFIG.BIN and reads
  544.               it if TMCONFIG.BIN is found on the DOS PATH.  Therefore, a
  545.               copy of TMCONFIG.BIN must reside in a directory that is on the
  546.               PATH in order for the saved configuration to be active when TM
  547.               starts.
  548.  
  549.          OTHER TM COMMANDS
  550.  
  551.                    TM provides other important functions through command
  552.          keys as described below.
  553.  
  554.               INS KEY
  555.  
  556.                    The Ins key is used to invoke the add directory function
  557.               that adds a directory to the current drive.  A window will
  558.               appear that prompts for the name of the directory to be
  559.               created.  It is important to note the position of the tree
  560.               cursor bar when invoking this function.  If it is desired to
  561.               add the directory to the root directory, type a DOS backslash
  562.               character ("\") as the first character in the name.  For
  563.               example, to add a directory named ARCM directly to the root
  564.               directory, type in \ARCM and press enter.  If however, it is
  565.               desired to append a subdirectory to the directory highlighted
  566.               by the cursor bar, do NOT precede the entry of the name with
  567.               the backslash character.  If the entered name is valid and if
  568.               another directory of the same name at the same level does not
  569.               exist, the directory will be created and added to the tree.
  570.               Note that the tree is resorted following the addition of a
  571.               directory.
  572.  
  573.               DEL KEY
  574.  
  575.                    Directories may be removed in TM by pressing the Del key
  576.               with the cursor bar over the target directory.  The remove
  577.               directory function will remove the directory from the drive
  578.               and from the tree.  Remember, the directory must not contain
  579.               any files or subdirectories
  580.               or an error will occur.  The target directory will be removed
  581.               from the drive and from the tree if the action is successful.
  582.  
  583.  
  584.  
  585.  
  586.  
  587.                                      - 10 -
  588.  
  589.  
  590.  
  591.               CTRL-END KEY
  592.  
  593.                    TM provides a fast, powerful method of cleaning up hard
  594.               disks through the directory purge function.  The entire
  595.               contents of a directory may be purged by pressing the Ctrl-End
  596.               key combination.  Not to worry, the user must confirm TWICE
  597.               before the action actually takes place and it is not possible
  598.               to purge the root directory while in TM.  A user might do a
  599.               lot of damage through negligent use of this function, so BE
  600.               CAREFUL!  Press the Ctrl-End key combination with the tree
  601.               cursor bar highlighting the target directory.  A window will
  602.               appear that will issue two separate prompts for user
  603.               confirmation of the purging action.  Please note that when TM
  604.               cleans out a directory, it takes with it ALL files, regardless
  605.               of attribute.  This means that hidden, read-only, system files
  606.               et al will be deleted.  After the purging action, a message
  607.               informing the user of success or failure will appear.
  608.               Directories containing subdirectories may be purged without
  609.               effecting the child subdirectories or their contents.
  610.  
  611.               CTRL-HOME KEY
  612.  
  613.                    Normally, changing directories is effected by moving the
  614.               cursor bar to the target directory and pressing return.  But
  615.               the root directory does not appear on the tree.  To change to
  616.               the root directory, press the Ctrl-Home key.
  617.  
  618.               TAB KEY
  619.  
  620.                    Pressing the Tab key toggles the functionality of the
  621.               up/down arrow keys as pertains to the movement of the cursor
  622.               bar from level to level.
  623.  
  624.               CTRL-M KEY
  625.  
  626.                    As distributed, TM uses a file mask of "*.*" (all files)
  627.               for retrieving file names from DOS for display in the file
  628.               list window.  This default can be changed through the use of
  629.               the Ctrl-M command.  A window will appear that prompts for
  630.               entry of the new file mask.  Any valid DOS file mask may be
  631.               entered.  After the mask is changed, only those files matching
  632.               the file mask will be displayed in the file list window.
  633.               Please note that the total file value that appears on the
  634.               window header will still show the total number of "*.*" files
  635.               in that directory.  Also note that the current file mask
  636.               setting will be saved to disk along with the other
  637.               configurable items when the user elects to reconfigure TM.
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.                                      - 11 -
  645.  
  646.  
  647.  
  648.               CTRL-S KEY
  649.  
  650.                    In consonance with the design employed in ArcMaster and
  651.               SCOUT, TM employs a directory catalog strategy.  This strategy
  652.               entails the storage of directory tree information in a small
  653.               file named NEW-WARE.LOG in the root directory of each drive
  654.               accessed.  Using this strategy greatly speeds up operation of
  655.               the program because it is not necessary to scan the entire
  656.               disk through DOS each time a drive is accessed.  The only
  657.               drawbacks to this strategy are minor and are far outweighed by
  658.               the increased performance.  If a directory is created,
  659.               renamed, or removed other than by TM, ArcMaster, or SCOUT, it
  660.               will be necessary to re-scan the drive to update the catalog.
  661.               This is accomplished by pressing the Ctrl-S.  Catalog
  662.               maintenance by TM is mostly automatic and re-scanning should
  663.               be a rare necessity.
  664.  
  665.     FILE BROWSE MODE
  666.  
  667.          The TM file browse mode is active when either the file search (F5
  668.     Key) or the directory browse (F9 key) functions are activated.  Files
  669.     are displayed in two columns of 21 files per column.  All files matching
  670.     the user-provided file specification will be listed and a movable cursor
  671.     bar is available to browse through the file list.  Up/Down arrow,
  672.     PgUp/PgDn, Home/End, Ctrl-PgUp/Ctrl-PgDn keys are can be used to move
  673.     through the list.  Files can be sorted in any one of five ways and the
  674.     sort may be changed at any time while in the browse mode.  The Tab Key
  675.     is used to toggle the direction of the sort to ascending or descending.
  676.     The F1 key provides information on all the commands available while in
  677.     the browse mode.  Individual files may be LISTed, EDITed, SCANed, or
  678.     executed from the browse mode.  In addition, ArcMaster may be called and
  679.     passed the file name under the cursor bar.
  680.  
  681.          TM provides a fast, easy method of finding a file name while in the
  682.     browse mode.  Pressing any key associated with a legal DOS file name
  683.     character will cause TM to search the entire browse list for a file name
  684.     beginning with that character.  If it finds one, the cursor will jump to
  685.     that file name and the first character typed will appear on line 23 of
  686.     the display.  TM will continue the search and build the search string
  687.     with each character pressed.  The backspace key may be used to delete
  688.     characters from the string and the string will be cleared any time a
  689.     cursor pad key (Down arrow, PgUp, Home, etc.) is pressed.  This feature
  690.     works best, of course, when the list is sorted by name in ascending
  691.     order.
  692.  
  693.     DIRECTORY NAME SEARCH
  694.  
  695.          Some users may have a large number of directories in a graphic tree
  696.     for a particular drive.  TM offers a quick method of moving the cursor
  697.     to a desired directory name that might be several display pages down in
  698.  
  699.  
  700.  
  701.                                      - 12 -
  702.  
  703.  
  704.  
  705.     the tree.  If a character key is pressed, TM will automatically search
  706.     through the tree and position the cursor on the directory name whose
  707.     first character matches the pressed key.  If a second character key is
  708.     immediately pressed, TM continues the search by searching for directory
  709.     names that match the two characters.  Subsequent character key presses
  710.     add to the search string and the cursor bar is moved each time a new
  711.     match is found.  The currently active search string is displayed at the
  712.     bottom of the tree.  The backspace key can be used to delete characters
  713.     from the string.  If any key other than an alphabetical character or
  714.     legal directory name character key is pressed, the search string is
  715.     cleared.
  716.  
  717.     PROGRAM LIMITATIONS
  718.  
  719.          TM is designed to operate on IBM PC/XT/AT/PS2 and compatible
  720.     computers.  It requires approximately 120K of free RAM at runtime.
  721.     Hercules, MDA, CGA, EGA, and VGA monitors are supported.
  722.  
  723.          TM supports up to 500 directories per drive.  The total number of
  724.     files that can be listed while in the browse mode is limited to 4000.
  725.     Since a 20 megabyte disk partition will contain an average of
  726.     approximately 1000 files, this limit should be adequate.  A warning
  727.     message will be displayed if the number of files TM can handle is
  728.     exceeded.  Please note that if a drive is searched using the global file
  729.     specification of "*.*" and the number of files on the drive exceeds
  730.     memory capacity, TM will terminate the find function before all files on
  731.     the disk are placed on the list.  Similarly, in the unlikely event that
  732.     TM is used on a drive that contains more than 500 directories, not all
  733.     available directories will appear on the tree.  Both of these
  734.     limitations are quite reasonable and should not hinder the majority of
  735.     users from exploiting the power of TreeMaster.
  736.  
  737.          While TM will operate perfectly well on 5 1/4" and 3 1/2" floppy
  738.     drives, it is designed for maximum efficiency on a hard drive.  Turning
  739.     off the file list display (F8) will speed up operations on a slow drive.
  740.  
  741.          The graphic tree printout functions sends IBM line drawing
  742.     characters to the printer.  Some printers do not directly support these
  743.     characters and may substitute non-line characters thus reducing the
  744.     quality of the resultant printout.
  745.  
  746.          The width of the window that contains the graphic tree display is
  747.     great enough to support 5 levels of directories with each directory name
  748.     eight characters in length.  Directory tree levels greater than five
  749.     with extended length names may overrun the right edge of the display.
  750.  
  751.     ERROR HANDLING
  752.  
  753.          TM incorporates extensive error handling.  DOS critical errors such
  754.     as "Drive not ready" and "Attempt to write to a write-protected disk"
  755.  
  756.  
  757.  
  758.                                      - 13 -
  759.  
  760.  
  761.  
  762.     are trapped and displayed to the user.  Any time TM cannot perform a
  763.     commanded function it will pop-up a window that informs the user of the
  764.     nature of the error.  Normal program operation then continues.
  765.  
  766.     CREDITS
  767.  
  768.          TM employs special code swapping software developed by Kim Kokkonen
  769.     of TurboPower Software.  This unit permits TM to swap most of its
  770.     resident code to expanded memory (EMS) or to disk when shelling out to
  771.     call external programs such as LIST or QEDIT.  If sufficient EMS memory
  772.     is available for the swap, the swap will be almost instantaneous.  If no
  773.     EMS is available, the swap will be made to a temporary disk file named
  774.     TMSWAP.$$$.  In this case there will be a noticeable delay during the
  775.     swap, especially if operating on a slow hard disk.  It is recommended
  776.     that swapping be kept OFF unless adequate EMS memory (350K+) is
  777.     available for swapping or a very fast hard disk system is in use.
  778.  
  779.          New-Ware strongly recommends Sammy Mitchell's (Sem-Ware)
  780.     outstanding text editor QEDIT.  TM supports calling QEDIT to edit files
  781.     on the browse list if a copy of QEDIT is named QEDIT.EXE and QEDIT.EXE
  782.     resides in a directory that is identified in the DOS PATH.
  783.  
  784.          TM supports LISTing files with Vernon Buerg's famous LIST program.
  785.     LIST must be named LIST.COM and reside on the DOS PATH.
  786.  
  787.          TM supports scanning full directories or selected files using John
  788.     McAfee's VirusSCAN program.  SCAN must be named SCAN.EXE and exist on
  789.     the DOS PATH.
  790.  
  791.          TM supports compressing or decompressing selected files using
  792.     PKWare's PKZIP and PKUNZIP.  These files must be named PKZIP.EXE and
  793.     PKUNZIP.EXE and reside on the DOS PATH.
  794.  
  795.          TM supports invocation of Pete Petrakis' free utility, LZESHELL
  796.     version 3.0.  LZESHELL is the ideal companion for LZEXE, which is a
  797.     marvelous utility that compresses .EXE and converted .COM files and
  798.     allows them to be executed in compressed form.  Be sure to read
  799.     LZESHELL.DOC for further information.
  800.  
  801.          TM also supports calling New-Ware's ArcMaster and passing it a
  802.     specified file name.  ArcMaster must be named AM.EXE and reside on the
  803.     DOS PATH.
  804.  
  805.          Portions of this software are taken from Turbo Pascal Express,
  806.     Revised by Robert Jourdain and are copyright 1987 by Robert Jourdain.
  807.  
  808.          QEDIT, LIST, PKZIP, and SCAN are all Shareware products.  New-Ware
  809.     urges that those who use these products register them with their
  810.     respective authors.
  811.  
  812.  
  813.  
  814.  
  815.                                      - 14 -
  816.  
  817.  
  818.  
  819.          TurboPower Software provides outstanding support for Turbo Pascal
  820.     programmers.  New-Ware strongly recommends TurboPower products to all
  821.     Pascal users.
  822.  
  823.     Copyright 1990, All Rights Reserved
  824.     New-Ware
  825.     8050 Camino Kiosco
  826.     San Diego, CA 92122-1820
  827.     (619) 455-6225
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.                                      - 15 -
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.                                      - 16 -
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.                                      Index
  940.  
  941.  
  942.            A                              F-4 key 8
  943.            add directory 10               F-5 key 8
  944.            Alt-F1 key 8                   F-6 key 8
  945.            Alt-R 4                        F-8 Key 9
  946.            Alt-X 6                        F-9 key 9
  947.            ASP 2                          F7 key 9
  948.            ASP Ombudsman 2                file list window 7
  949.                                           file mask 11
  950.            B                              file search 8
  951.            backspace key 13               function keys 7
  952.  
  953.            C                              G
  954.            change drive 8                 Genie 3
  955.            color attributes 6
  956.            Compuserve 3                   H
  957.            Ctrl-End key 11                Home key 6
  958.            Ctrl-Home key 11
  959.            Ctrl-M 11                      I
  960.            Ctrl-S 12                      Ins key 10
  961.            Ctrl-T 6
  962.            cursor bar 6                   L
  963.                                           Left Arrow key 7
  964.            D                              left button 7
  965.            Del key 10
  966.            directory catalog 12           N
  967.            directory purge 11             New-Ware 3
  968.            DISCLAIMER 2
  969.            DOS PATH 6                     P
  970.            drive information 8            PATHINFO.TXT 6
  971.                                           PgUp and PgDn 6
  972.            E                              printout 8
  973.            End key 6                      PRODUCT LICENSE 2
  974.            ENTER key 7                    PROLOG 2
  975.            errors 13
  976.            Esc key 6                      Q
  977.                                           Quit and Save 10
  978.            F
  979.            F-3 8                          R
  980.            F-10 key 10                    re-scan 12
  981.            F-1 Key 8                      register 2
  982.            F-2 key 8                      REGISTRATION 3
  983.  
  984.  
  985.  
  986.                                      - 17 -
  987.  
  988.  
  989.  
  990.            registration fee 3             T
  991.            registration window 4          Tab Key 12
  992.            remove directory 10            Tab key 6, 11
  993.            rename a directory 8
  994.            Right Arrow key 7              U
  995.            right button 7                 Up/Down Arrow 6
  996.  
  997.            S                              V
  998.            Shareware 2                    VENDOR.DOC 4
  999.            Shareware Products BBS 3
  1000.            Shareware version 3
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.                                      - 18 -
  1044.  
  1045.  
  1046.